Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / PostScript Imaging Messages

GXPostScriptDoPageSetup

QuickDraw GX sends the GXPostScriptDoPageSetup message to set up page-level formatting information. You can override the GXPostScriptDoPageSetup message to customize the page setup information. Your override of the GXPostScriptDoPageSetup message must match the following formal declaration:

OSErr MyPostScriptDoPageSetup (gxFormat aFormat, long pageIndex,
                        gxPostScriptImageDataHandle hImageData);

aFormat

The format object for the page to be printed.

pageIndex

The number of the page that is about to be imaged.

hImageData

A handle to the PostScript imaging system structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPostScriptDoPageSetup message after a page has been spooled and before it is imaged. This message performs all necessary actions for setting up the page in the printer, including initiating the GXPostScriptSelectPaperType message.

The default implementation of this message takes the page-formatting information and translates it into PostScript code. You can override this message if you need to perform any special actions for specific page numbers.

SPECIAL CONSIDERATIONS

You always forward the GXPostScriptDoPageSetup message to allow other message handlers the opportunity to perform page setup tasks.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXPostScriptDoPageSetup message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The PostScript imaging system structure is described on page 4-26.

The GXPostScriptSelectPaperType message is described in the next section.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help